home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / program / nwlib15.zip / README.1ST < prev    next >
Text File  |  1996-06-08  |  12KB  |  249 lines
  1.  
  2.                ██▐███  ██▐███ ██   ██  █▐███  ██▐████ █▌████
  3.                ██   ██ ██     ██   ██ ██   ██ ██   ██   ██
  4.                ██   ██ ██▐█   ██   ██ ██   ██ ██   ██   ██
  5.                ██   ██ ██      █▐ ██  ██   ██ ██   ██   ██
  6.                ██▐███  ██▐███   ▐██    █▐███  ██   ██   ██
  7.         ██▐███  █▐███  ██▐███ █▌████ ██   ██  █████  ██▐███  ██▐███
  8.         ██     ██   ██ ██       ██   ██   ██ ██   ██ ██   ██ ██
  9.         ██▐███ ██   ██ ██▐█     ██   ██ █ ██ ██▐████ ██▐███  ██▐█
  10.             ██ ██   ██ ██       ██   ██ █ ██ ██   ██ ██ ██   ██
  11.         ██▐███  █▐███  ██       ██    █▐███  ██   ██ ██   ██ ██▐███
  12.                           I N C O R P O R A T E D
  13.  
  14.                 (713) 370-4215 fax         (713) 370-0841 bbs
  15.                              18026 Deep Brook
  16.                              Spring, TX 77379
  17.  
  18.                       http://www.wworks.com/~devont
  19.  
  20.  
  21. Thanks for checking out NWLib!  We certainly appreciate your spending
  22. the time to look at our library.  We think you'll agree it was time
  23. well spent once you open up the demo project and compile it for the
  24. first time.
  25.  
  26. NWLib contains a very rich set of Netware-specific functions that make
  27. adding Netware specific features to your application extremely easy.  In
  28. most cases, you just plop an icon or two on your form, then make a single
  29. function call to incorporate a very complex Netware service into your
  30. application.  You won't find a Netware library that's easier to use, or
  31. more compatible with industry standards than NWLib.
  32.  
  33. Even better, you can even purchase the complete original source used to
  34. create the NWLib library set.  No matter if your Delphi skills are
  35. novice or expert, you are sure to gain valuable low-level knowlege
  36. about the Novell API set, or making external DLL function calls simply
  37. by using the NWLib source code.
  38.  
  39. And with Devont's unique 'function buy-back' program, you can earn your
  40. source code purchase price back simply by submitting functions to become
  41. part of the library itself.  You get complete credit for your input, plus
  42. actually PAID for your submissions.  Download the Source Code information
  43. kit from the Devont Software BBS, or WWW page for more information regarding
  44. this unique program.
  45.  
  46. We sincerely hope for success in your endeavors.  Please let me know if I
  47. can be of any help getting your product or projects completed.  We are always
  48. open to suggestions, additions and improvements to the library, and greatly
  49. appreciate your comments and input.
  50.  
  51. Happy Programming!
  52.  
  53. Jim Tyson
  54. Developer
  55. Devont Software Inc.
  56.  
  57.  
  58.                            ┌──────────────┐
  59.                            │ Installation │
  60.                            └──────────────┘
  61.  
  62. The installation of NWLib is easy.  You need only to copy the supplied
  63. files to a new directory on your hard disk drive, then add the unit to
  64. your component palette.  To do this, complete the following steps (if
  65. you have an older NWLib version installed, please see the section
  66. titled "Upgrading From Older NWLIB Versions" later in this document.
  67.  
  68. 1.  Make a backup copy of your COMPLIB.DCL file, usually found in the
  69.     \DELPHI\BIN directory.  Remove any existing NWLib component from
  70.     the Delphi Palette by using Delphi's Options|Install Components
  71.     menu option.
  72.  
  73. 2.  Make a new directory on your hard disk drive, and copy the contents
  74.     of the supplied NWLIB files into this new directory.  A good place
  75.     to put this is in a directory such as \DELPHI\NWLIB.
  76.  
  77. 3.  In Delphi, close all windows, projects, units, etc.
  78.  
  79. 4.  In Delphi, select the 'Options|Install Components' menu item.  On
  80.     the displayed dialog box, use the 'Add' button to specify the
  81.     NWLIB.DCU file as a new component to add to your palette.  Use the
  82.     'Browse' button to locate and specify the name of the component using
  83.     the location specified in step 2.
  84.  
  85. 5.  When complete, Delphi rebuilds the component library, and adds a new
  86.     tab to your selection list.  When you click on the new NWLib tab,
  87.     you'll see NWLib's four seperate component units: TNWLib, TNWServer,
  88.     TNWPrint and TNWTools.
  89.  
  90.                          ┌────────────────────┐
  91.                          │   Upgrading from   │
  92.                          │ Old NWLib Versions │
  93.                          └────────────────────┘
  94.  
  95. If you are upgrading from a version of NWLib prior to 1.4, you'll need
  96. to perform a few things before proceeding with your installation:
  97.  
  98. MOST IMPORTANT: ALL NWLib bindery and environment gathering functions now
  99. require the desired Server Connection Handle as the first parameter.  In
  100. older versions, these API calls were defaulted to the current server
  101. connection handle.  This meant if you actually wanted to receive the
  102. object ID of another user on a different server than your current server,
  103. you needed to make that server the default before making the call.  Since
  104. some of the new bindery/environmental calls required these base functions,
  105. we needed to include this parameter for those working under a multi-server
  106. network.
  107.  
  108. In NWLib 1.4 and above, you can pass 0 (zero) as the server connection
  109. handle, and NWLib will assume you mean the 'default' or current server
  110. connection handle.  This means you can simply drop the new version in,
  111. and build all of your projects files.  As the compiler stops on a line
  112. that used to properly compile with a warning such as 'invalid type,'
  113. simply place a 0 (zero) as the first parameter of the call if you want
  114. the current server, or pass the desired server connection handle and the
  115. function will use that connection handle instead.
  116.  
  117.  
  118. Example: WhoAmI used to require no parameters.  In this release and up,
  119. WhoAmI(0) is the equivalent.  You can also do:
  120. WhoAmI(some_server_conn_handle) to obtain your User ID on a different
  121. server.  See also getObjName, getObjType, getObjectID, etc.  All
  122. examples included in the DEMO project.
  123.  
  124. Please, make sure you back up your projects before attempting to upgrade
  125. the NWLib calls.  We would not want you to lose any productive time
  126. because of a mistake or misunderstanding about a particular function
  127. change.
  128.  
  129.                           ┌──────────────────┐
  130.                           │ The Demo Project │
  131.                           └──────────────────┘
  132.  
  133. We've included a complete demonstration project to help you get
  134. started using NWLib.  Simply open the project in Delphi, then
  135. select the 'Run' button to build the executable and run the
  136. program.
  137.  
  138. Then, you can use Delphi to take apart the demo and see how easy
  139. it is to add exciting Netware features to your own Delphi applications.
  140.  
  141. Note the demo project makes an assumption you are running Netware 2.x
  142. or Netware 3.x.  If you are running Netware 4.x, you'll need to make
  143. some changes to the group names used in the program.  For example, one
  144. list is built using the EVERYONE group.  If this group does not exist
  145. in your NDS tree, you'll need to change the name.
  146.  
  147.                            ┌─────────────┐
  148.                            │ Source Code │
  149.                            └─────────────┘
  150.  
  151. NWLib source code is now available!  If you are a CompuServe user,
  152. you can use our SWREG number to pay for your copy of the source code,
  153. and have the purchase appear on your CompuServe invoice.  You pay
  154. CompuServe directly.  They handle the currency exchange, billing,
  155. and all other details for you.  If you are purchasing from your own
  156. account and passing the charge on to your company or other party,
  157. you can use your CompuServe statement for reimbursement of the expense.
  158.  
  159. NWLib Source code is licensed per programmer.  That is, only one programmer
  160. at a time can view or edit any source code containing NWLib functions. The
  161. first NWLib source code license is $100.00 retail.  Additional source code
  162. licenses are only $40.00.
  163.  
  164. You must already own one or more NWLib library licenses before you
  165. can purchase any NWLib source code licenses.  You must agree to the
  166. terms and limitations stated in the NWLib Source Code license agreement
  167. before opening the NWLib source code diskette envelope.
  168.  
  169. CompuServe SWREG Number for NW